home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / BBS / HMSG105.ZIP / HMSG.DOC < prev    next >
Encoding:
Text File  |  1996-02-19  |  8.7 KB  |  265 lines
  1.  
  2.  
  3.  
  4.      HMSG 1.05, A Frontend to Harvey's Robot                           Page 1
  5.  
  6.  
  7.      1.  Warranty
  8.  
  9.      HMSG IS FREELY AVAILABLE, BUT COPYRIGHTED BY Gary A. Mays. Gary A.  Mays
  10.      OFFERS NO WARRANTY, EITHER EXPRESS OR IMPLIED, WITH REGARD TO THE USE OF
  11.      HMSG  AND  HEREBY  DISCLAIMS  ANY  AND   ALL   IMPLIED   WARRANTIES   OF
  12.      MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  13.  
  14.      IN  NO EVENT WILL Gary A. Mays BE LIABLE FOR INCIDENTAL OR CONSEQUENTIAL
  15.      DAMAGES, INCLUDING, BUT NOT LIMITED TO, DESTRUCTION OF DATA OR DAMAGE TO
  16.      YOUR EQUIPMENT.
  17.  
  18.  
  19.  
  20.  
  21.      2.  HMSG 1.05, A Frontend to Harvey's Robot
  22.  
  23.      HMSG  simplifies the use of Harvey's Robot, an inbound/outbound 4d *.PKT
  24.      robot mail system (ROBOT600.ZIP). HMSG is freely available, just  as  is
  25.      Harvey's   Robot.   Harvey's   robot   is  available  at  1:261/1191  as
  26.      ROBOT600.ZIP. File requests are honored from 6pm until 8am.
  27.  
  28.      HMSG uses an internal configuration to create a temporary  configuration
  29.      file for Harvey's Robot for each message. The temporary configuration is
  30.      written to the directory specified in your system's environment variable
  31.      TEMP. If TEMP is undefined, then the root directory of the current drive
  32.      is used. It is recommend that a ram disk be used as the TEMP directory.
  33.  
  34.      HMSG uses unique filenames for the temporary control file. This prevents
  35.      collisions in multitasking environments.
  36.  
  37.      When  the  default  message  attributes are configured, a message can be
  38.      sent with only one or two command line switches required:
  39.  
  40.            DIR D:\NEWFILES | HMSG -S"Newfiles" -toss
  41.  
  42.      will send me a message listing newly arrived  files.  The  -toss  switch
  43.      calls your configured mail tosser to toss the robot message packet.
  44.  
  45.      HMSG  -?  will  display  the  help  screen. HMSG CONFIG will display the
  46.      configuration screen.
  47.  
  48.  
  49.  
  50.      3.  HELP SCREEN
  51.  
  52.      HMSG v1.04 - Frontend to Harvey's Robot by Gary A. Mays
  53.      Switches:(Activated with - or /, but cannot mix) Config with HMSG CONFIG
  54.        -p:packets-path          Inbound for FrontDoor,  Inbound  or  Outbound
  55.                                 for Binkley.
  56.        -e:packets-extension     PKT, OUT, ...
  57.        -area:area-name          Default is nothing which is netmail.
  58.        -attr:message-attributes 0=Public,  P=Private,  A=F'Att, R=F'Req. When
  59.                                 other no attr are specified, then the default
  60.                                 is  P for netmail and 0 for echomail. A and R
  61.                                 don't work when from inbound.
  62.        -fn:"from-name"          Double quotes required to preserve  case  and
  63.                                 when there are imbedded spaces.
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      HMSG 1.05, A Frontend to Harvey's Robot                           Page 2
  71.  
  72.  
  73.        -fa:from-address
  74.        -tn:"to-name"
  75.        -ta:to-address!password  !password:   8   character   optional  packet
  76.                                 password prefix with !
  77.        -s:subject
  78.        -m:message-file          No file outputs single line of ---
  79.        -k                       Erase the  message-file  named  with  the  -m
  80.                                 switch');
  81.        -o:"origin line"
  82.        -toss                    Toss  PKT  with  configured tosser (HMSG does
  83.                                 not swap before shell).
  84.      Instead of specifying message text with -M, message text  can  be  piped
  85.      from a program or redirected from a file. Just use:
  86.  
  87.            PGM | HMSG -S"Info"
  88.  
  89.      or
  90.  
  91.            HMSG -S"Subject" <filename
  92.  
  93.      When the piped or re-directed input is empty, then HMSG will abort.
  94.  
  95.      The  -toss  switch  is  not  used  when  you  have specified an outbound
  96.      directory to receive the mail packet.
  97.  
  98.      The configured 'ECHOMAIL Default From Address' is used as a template for
  99.      the  to-address  and  from-address  switches:  -ta  and  -fa. An address
  100.      specified for -ta and -fa can be NODE or NODE.POINT or .POINT,  and  the
  101.      missing components will be taken from the template.
  102.  
  103.      Parameters  not  enclosed  in double quotes are converted to upper case.
  104.      Parameters that have imbedded spaces must be enclosed in double  quotes.
  105.      Commas  in  all  parameters  will  be  stripped  out  because the robots
  106.      configuration file uses commas to separate the parameters. The colon  in
  107.      the  parameters  is  used  for  readability and is optional. All options
  108.      except -m and -attr are configurable  by  HMSG  CONFIG.  HMSG  writes  a
  109.      temporary   configuration   file  to  the  directory  specified  by  the
  110.      environment variable TEMP, or to the root directory of the current drive
  111.      if TEMP is not defined.
  112.  
  113.  
  114.  
  115.      4.  MY CONFIGURATION SCREEN
  116.  
  117.  
  118.      HMSG 1.04 - Frontend to Harvey's Robot by Gary A. Mays
  119.       Specify paths without trailing "\"
  120.      Configuration area of D:\BBSUTIL\HMSG.EXE (Prefix Ctrls with Ctrl-P)
  121.  
  122.      Path to Harvey's Robot: d:\harvey
  123.      Path to packets: D:\INBOUND
  124.      Packet extension: PKT
  125.  
  126.      Netmail toss command:
  127.      hstart "Tossing Netmail from H.EXE" /fs /b /c sq386p in
  128.      Echomail toss/scan command:
  129.      hstart "Tossing Echomail from H.EXE" /fs /b /c sq386p in out link squash
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      HMSG 1.05, A Frontend to Harvey's Robot                           Page 3
  137.  
  138.  
  139.  
  140.      Default Area name (blank for netmail):
  141.      Default From name: Sysop
  142.      NETMAIL Default From address (A point of your address): 1:261/1191.1
  143.      ECHOMAIL Default From address (Your address): 1:261/1191
  144.      Default To name: SysOp
  145.      Default To address (Your address): 1:261/1191
  146.      Default Subject: Sysop message
  147.      Default Origin line: Gary's Desk * Baltimore MD * USA
  148.  
  149.  
  150.  
  151.  
  152.      5.  HINTS
  153.  
  154.      I have not tested the use of Harvey's Robot with BinkleyTerm. You may be
  155.      able to set the packet name to OUT, CUT, HUT or whatever and  place  the
  156.      packet   into   your  outbound.  I  use  FrontDoor  which  does  dynamic
  157.      scheduling. It's packet area is modified on the fly  and  cannot  accept
  158.      packets placed there by another program.
  159.  
  160.      I  have  H.EXE  create PKTs in my inbound. Messages that are tossed from
  161.      the inbound are  not  flagged  as  Local.  FrontDoor  will  not  forward
  162.      non-local  messages  from  your  own address. To send netmail to another
  163.      node, I had to specify a FROM address other  than  my  own  primary  net
  164.      address (I used .700 of my primary address).
  165.  
  166.      If you have more than one message to be generated from the same address,
  167.      HR will just add to the packet in the inbound.
  168.  
  169.      HMSG does not swap when exec'ing a command. H.EXE  does  not  need  much
  170.      memmory,  so  it  works  OK.  If  you  use  the -toss switch to call the
  171.      configured tosser, your tosser may not have enough memory to operate. If
  172.      you  are  using  OS/2, you can use HSTART to start a task to process the
  173.      inbound.
  174.  
  175.  
  176.  
  177.      6.  BinkleyTerm Netmail
  178.  
  179.      If you use BinkleyTerm you may only have to specify your outbound as the
  180.      packets  directory  and  specify  OUT  or CUT or something as the packet
  181.      type. Your tosser would not be involved.
  182.  
  183.  
  184.  
  185.      7.  BinkleyTerm EchoMail
  186.  
  187.      If you use BinkleyTerm and you create an echomail message and want it to
  188.      appear  in  your echomail area, you must place a PKT in your inbound and
  189.      process it with your tosser just as I do with FrontDoor.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      HMSG 1.05, A Frontend to Harvey's Robot                           Page 4
  203.  
  204.  
  205.      8.  Examples
  206.  
  207.  
  208.  
  209.      8.1.  Send a text file as a message
  210.  
  211.  
  212.            hmsg -s"Here is your info" -ta1:261/1191.2 -toss -mfile.txt
  213.  
  214.  
  215.      8.2.  Send a weekly mail history report
  216.  
  217.  
  218.      mailhist -dlastweek -a.2 |hmsg -s"Mail history" -ta1:261/1191.2 -toss
  219.  
  220.      MAILHIST creates a report from FrontDoor's history files.
  221.  
  222.  
  223.      8.3.  Send list of non-message/non-tic'ed inbound files
  224.  
  225.  
  226.            showfile d:\inbound |hmsg -s"Non-mail files"  -toss
  227.  
  228.      SHOWFILE.EXE does not produce an output when the output  is  re-directed
  229.      AND  there  are  no non-mail/non-tic'ed files. This allows HMSG to abort
  230.      the message.
  231.  
  232.  
  233.      8.4.  Send report of errors in ALIAS.TXT
  234.  
  235.  
  236.            valias d:\misc\alias.txt|hmsg -s"Bad alias definitions"  -toss
  237.  
  238.      VALIAS.EXE does not produce an output when the output is re-directed AND
  239.      there are no errors. This allows HMSG to abort the message.
  240.  
  241.  
  242.      The  latest  versions of the programs MAILHIST, SHOWFILE, and VALIAS are
  243.      available from the author's system by the same magic name  as  the  main
  244.      .EXE.
  245.  
  246.  
  247.  
  248.  
  249.      Gary A. Mays 1:261/1191@fidonet
  250.      5248 Reisterstown Rd #1
  251.      Baltimore, MD 21215
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.